package com.iiiu.payment.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.iiiu.payment.domain.dto.PageQueryDTO;
import com.iiiu.payment.domain.dto.PaymentDTO;
import com.iiiu.payment.domain.entity.Payment;

import java.math.BigDecimal;
import java.util.List;

/**
 * 花销记录服务接口
 */
public interface PaymentService extends IService<Payment> {

    /**
     * 分页查询花销记录
     * @param pageQueryDTO 分页查询条件
     * @return 花销记录分页数据
     */
    IPage<Payment> getPaymentPage(PageQueryDTO pageQueryDTO);

    /**
     * 根据用户ID查询花销记录列表
     * @param userId 用户ID
     * @return 花销记录列表
     */
    List<Payment> getByUserId(Long userId);

    /**
     * 根据ID查询花销记录详情
     * @param id 花销记录ID
     * @param userId 用户ID
     * @return 花销记录详情
     */
    PaymentDTO getPaymentById(Long id, Long userId);

    /**
     * 创建花销记录
     * @param payment 花销记录信息
     * @return 创建的花销记录
     */
    Payment createPayment(Payment payment);

    /**
     * 更新花销记录
     * @param payment 花销记录信息
     * @return 更新后的花销记录
     */
    Payment updatePayment(Payment payment);

    /**
     * 删除花销记录（软删除）
     * @param id 花销记录ID
     * @param userId 用户ID
     * @return 是否删除成功
     */
    boolean deletePayment(Long id, Long userId);

    /**
     * 统计用户总花销
     * @param userId 用户ID
     * @return 总花销金额
     */
    BigDecimal getTotalAmountByUserId(Long userId);

    /**
     * 根据分类ID统计花销
     * @param userId 用户ID
     * @param categoryId 分类ID
     * @return 分类花销金额
     */
    BigDecimal getTotalAmountByCategoryId(Long userId, Long categoryId);

    /**
     * 根据支付方式ID统计花销
     * @param userId 用户ID
     * @param paymentMethodId 支付方式ID
     * @return 支付方式花销金额
     */
    BigDecimal getTotalAmountByPaymentMethodId(Long userId, Long paymentMethodId);

    /**
     * 批量删除花销记录
     * @param ids 花销记录ID列表
     * @param userId 用户ID
     * @return 是否删除成功
     */
    boolean batchDeletePayments(List<Long> ids, Long userId);
}